Adds two variables that are indexed by landuse x pft dimension. This is useful for looking at complex dynamics under land use change.

Description:

adds two new variables: FATES_VEGC_LUPF and FATES_NOCOMP_PATCHAREA_LUPF.

This requires CTSM PR ESCOMP/CTSM#3760 (or at least commit ESCOMP/CTSM@87e861f) to function. The corresponding E3SM-side code changes were integrated a while ago, in commit E3SM-Project/E3SM@587932c, so this code should work as-is in ELM.

Collaborators:

@glemieux is bringing in the CTSM-side changes. Discussed earlier today with @rosiealice.

Expectation of Answer Changes:

bit for bit except for new variables added

Checklist

If this is your first time contributing, please read the CONTRIBUTING document.

All checklist items must be checked to enable merging this pull request:

Contributor

• The in-code documentation has been updated with descriptive comments
• The documentation has been assessed to determine if updates are necessary

Integrator

• FATES PASS/FAIL regression tests were run
• Evaluation of test results for answer changes was performed and results provided
• FATES-CLM6 Code Freeze: satellite phenology regression tests are b4b

If satellite phenology regressions are not b4b, please hold merge and notify the FATES development team.

Documentation

• Technical Note update:
• User's Guide update:

Test Results:

CTSM (or) E3SM (specify which) test hash-tag:

CTSM (or) E3SM (specify which) baseline hash-tag:

FATES baseline hash-tag:

Test Output: